package org.dromara.system.service;

import org.dromara.common.mybatis.core.page.PageQuery;
import org.dromara.common.mybatis.core.page.TableDataInfo;
import org.dromara.system.domain.bo.SysClientBo;
import org.dromara.system.domain.vo.SysClientVo;

import java.util.Collection;
import java.util.List;


/**
 * @Author 刘武贵
 * @Date 2024/8/15 22:00
 * @Description 功能描述：客户端管理Service接口
 */
public interface ISysClientService {

    /**
     * 查询客户端管理
     *
     * @param id 客户端ID
     * @return 返回SysClientVo对象，包含客户端详细信息
     */
    SysClientVo queryById(Long id);

    /**
     * 查询客户端信息基于客户端id
     *
     * @param clientId 客户端ID，用于查询
     * @return 返回SysClientVo对象，包含客户端详细信息
     */
    SysClientVo queryByClientId(String clientId);

    /**
     * 查询客户端管理列表
     *
     * @param bo 查询条件对象，SysClientBo包含查询条件
     * @param pageQuery 分页查询对象，包含分页信息如当前页码和每页记录数
     * @return 返回TableDataInfo对象，包含分页数据和总记录数
     */
    TableDataInfo<SysClientVo> queryPageList(SysClientBo bo, PageQuery pageQuery);

    /**
     * 查询客户端管理列表
     *
     * @param bo 查询条件对象，SysClientBo包含查询条件
     * @return 返回SysClientVo对象列表，包含所有符合条件的客户端信息
     */
    List<SysClientVo> queryList(SysClientBo bo);

    /**
     * 新增客户端管理
     *
     * @param bo 包含要插入数据的SysClientBo对象
     * @return 返回布尔值，表示是否新增成功
     */
    Boolean insertByBo(SysClientBo bo);

    /**
     * 修改客户端管理
     *
     * @param bo 包含要更新数据的SysClientBo对象
     * @return 返回布尔值，表示是否更新成功
     */
    Boolean updateByBo(SysClientBo bo);

    /**
     * 修改状态
     *
     * @param clientId 客户端ID，标识要修改状态的客户端
     * @param status 新的状态
     * @return 返回修改状态的行数
     */
    int updateUserStatus(String clientId, String status);

    /**
     * 校验并批量删除客户端管理信息
     *
     * @param ids 要删除的客户端ID集合
     * @param isValid 校验标志，表示是否需要进行删除前的校验
     * @return 返回布尔值，表示是否删除成功
     */
    Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);

}
